W02-1. Docker 기본 - 강의 노트

2주차 강의 노트: 이미지와 컨테이너 생명주기

이번 주 목표

  1. 컨테이너의 상태(생명주기) 와 상태를 바꾸는 명령어를 안다.
  2. stop 과 kill 의 차이, 그리고 "정상 종료" 가 왜 중요한지 안다.
  3. "메인 프로세스가 끝나면 컨테이너도 끝난다" 는 규칙을 안다.
  4. 컨테이너 로그를 보는 법과 재시작 정책을 안다.
  5. 이미지의 전체 이름, 태그, 다이제스트, 멀티 플랫폼을 안다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • 컨테이너 = 격리된 프로세스 (Namespace 로 보이는 범위를, cgroups 로 쓰는 양을 제한)
  • 이미지 = 읽기 전용 설계도 → 컨테이너 = 실행된 상태
  • 컨테이너를 지우면 안에서 바꾼 내용은 사라짐


1. 컨테이너의 일생: 생명주기

컨테이너는 만들어지고, 실행되고, 멈추고, 지워집니다. 각 상태와 상태를 바꾸는 명령어는 아래와 같습니다.

flowchart LR
    I(["이미지"]) -- "docker create" --> C["Created
(만들어짐)"] I -- "docker run
(= create + start)" --> R C -- "docker start" --> R["Running
(실행 중)"] R -- "docker pause" --> P["Paused
(얼림)"] P -- "docker unpause" --> R R -- "docker stop / kill
메인 프로세스 종료" --> E["Exited
(종료됨)"] E -- "docker start" --> R E -- "docker rm" --> X(["삭제"])

docker restart 는 Running 상태에서 "stop → start" 를 한 번에 하는 명령입니다.

상태 docker ps -a 의 STATUS 뜻
Created Created 만들어만 두고 아직 실행 안 함
Running Up 3 seconds 실행 중
Paused Up 10 seconds (Paused) 일시정지. 프로세스를 얼려 둔 상태. 메모리는 그대로지만 CPU 는 전혀 안 씀
Exited Exited (0) 5 seconds ago 종료됨. 괄호 안 숫자는 종료 코드
(삭제됨) 목록에서 사라짐 docker rm 으로 지운 상태
docker run = docker create + docker start

지난주에 쓴 docker run 은 만들기와 실행을 한 번에 하는 명령입니다. 이미지가 없으면 pull 까지 알아서 합니다.

Exited 상태의 컨테이너는 "꺼진 컴퓨터"

멈춘(Exited) 컨테이너는 지우기 전까지 안의 변경 내용을 그대로 갖고 있습니다. docker start 로 다시 켤 수 있습니다.
그래서 docker ps -a 에 멈춘 컨테이너가 쌓이면 디스크를 차지합니다. 다 쓴 것은 docker rm 으로 지웁니다.


2. stop 과 kill: 정중하게 끄기 vs 플러그 뽑기

명령 하는 일 비유
docker stop ① 메인 프로세스에 SIGTERM("이제 정리하고 끝내 주세요")을 보냄
② 정해진 시간 동안 기다림
③ 그래도 안 끝나면 SIGKILL(강제 종료)
컴퓨터 시스템 종료 버튼
docker kill 처음부터 SIGKILL 로 즉시 강제 종료 전원 플러그 뽑기
sequenceDiagram
    participant D as Docker
    participant P as 컨테이너 메인 프로세스
    D->>P: SIGTERM (정리하고 종료해 주세요)
    alt 프로세스가 신호를 처리함 (예: nginx)
        P-->>D: 하던 요청 마무리 후 스스로 종료 → Exited (0)
    else 신호를 무시함 (예: sleep)
        Note over D: 대기 시간(-t) 만큼 기다림
        D->>P: SIGKILL (강제 종료)
        P-->>D: Exited (137)
    end

종료 코드 읽는 법

종료 코드 의미
0 정상 종료
1 등 작은 숫자 앱이 에러로 종료
137 SIGKILL 로 강제 종료됨 (128 + 9번 신호). 메모리 초과(OOM)로 죽었을 때도 137
143 SIGTERM 을 받고 종료됨 (128 + 15번 신호)
정상 종료(Graceful Shutdown)가 왜 중요한가

웹 서버는 처리 중이던 요청을 마저 끝내야 하고, DB 는 메모리의 데이터를 디스크에 써야 합니다.
강제 종료(SIGKILL)를 당하면 요청이 끊기거나 데이터가 깨질 수 있습니다.
7주차 Kubernetes 무중단 배포도 결국 "컨테이너를 정중하게 끄고 새로 켜는 것"입니다.

기다리는 시간(대기 시간)

  • 리눅스 서버의 Docker Engine 기본값은 10초입니다.
  • Docker Desktop 에서는 이보다 짧게 동작할 수 있습니다. 실습 노트북(4.93)에서는 약 3초였습니다.
  • 그래서 실습에서는 docker stop -t 5 처럼 시간을 직접 정해서 모두 같은 결과가 나오게 합니다.
  • 참고로 Kubernetes 의 기본 대기 시간은 30초입니다(10주차).


3. 핵심 규칙: 메인 프로세스가 끝나면 컨테이너도 끝난다

컨테이너는 메인 프로세스(PID 1) 하나를 위해 존재합니다. 메인 프로세스가 끝나는 순간 컨테이너도 Exited 가 됩니다.

실행한 것 메인 프로세스 결과
docker run -d alpine:3.24 echo hi echo hi 글자 하나 찍고 끝 → 바로 Exited (0)
docker run -d ubuntu:26.04 bash (입력 없음) 할 일이 없어 끝 → 바로 Exited (0)
docker run -d nginx:1.30-alpine nginx (계속 요청 대기) 계속 Running
docker run -d alpine:3.24 sleep 3600 sleep 3600 1시간 뒤 Exited
초보자가 가장 많이 하는 실수

"docker run -d ubuntu:26.04 했는데 컨테이너가 바로 꺼져요!"
→ 고장 난 게 아니라 할 일(메인 프로세스)이 없어서 끝난 것입니다.
컨테이너는 VM 처럼 "켜 두는 컴퓨터" 가 아니라 "프로그램 하나를 실행하는 상자" 입니다.


4. 로그: 컨테이너 앱은 화면에 출력한다

컨테이너 안의 앱은 로그를 파일 대신 표준 출력(stdout) / 표준 에러(stderr) 로 내보내는 것이 원칙입니다. Docker 가 이 출력을 모아 두었다가 docker logs 로 보여 줍니다.

flowchart LR
    A["컨테이너 안의 앱
(nginx)"] -- "stdout / stderr" --> D["Docker Engine
(로그 저장)"] D -- "docker logs" --> U["나 (터미널)"] D -. "운영 환경에서는" .-> M["로그 수집 시스템
(10주차 맛보기)"]
명령 하는 일
docker logs <이름> 지금까지의 로그 전체
docker logs --tail 20 <이름> 마지막 20줄만
docker logs -f <이름> 실시간으로 계속 보기 (Ctrl + C 로 빠져나옴)
docker logs -t <이름> 줄마다 시간 표시
docker logs --since 10m <이름> 최근 10분 로그만
nginx 공식 이미지의 비밀

nginx 는 원래 /var/log/nginx/access.log 파일에 로그를 씁니다. 공식 이미지는 이 파일을 표준 출력으로 연결해 두었습니다. 그래서 docker logs 로 접속 기록이 보입니다.


5. 재시작 정책: 죽으면 다시 살려 줄까?

docker run --restart <정책> 으로, 컨테이너가 멈췄을 때 Docker 가 자동으로 다시 켤지 정합니다.

정책 동작 언제 쓰나
no (기본값) 다시 켜지 않음 실습, 일회성 작업
on-failure[:횟수] 에러로 종료(코드 0이 아님)했을 때만 다시 켬 배치 작업
always 어떤 이유로 멈춰도 다시 켬. Docker 가 재시작되면 같이 켜짐 -
unless-stopped always 와 같지만, 사람이 docker stop 으로 끈 것은 존중함 서버에 띄워 두는 서비스 (가장 많이 씀)
Kubernetes 예고

재시작 정책은 "서버 한 대 안에서" 살려 주는 기능입니다.
서버 자체가 죽으면? 다른 서버에서 다시 띄워 줘야 합니다. 이것이 6주차부터 배울 Kubernetes 의 역할입니다.


6. 이미지 이름을 정확히 읽기

6-1. 전체 이름

우리가 nginx:1.30-alpine 이라고 짧게 쓰면, Docker 는 아래처럼 빈 부분을 기본값으로 채웁니다.

docker.io/library/nginx:1.30-alpine 을 네 부분으로 나누면:

부분 값 뜻 생략하면
레지스트리 docker.io 이미지 저장 서버 Docker Hub (docker.io)
계정(네임스페이스) library 누구의 이미지인지 공식 이미지(library)
저장소(repository) nginx 이미지 이름 생략 불가
태그(tag) 1.30-alpine 버전 / 종류 latest
이렇게 쓰면 실제 이름
nginx docker.io/library/nginx:latest
nginx:1.30-alpine docker.io/library/nginx:1.30-alpine
내아이디/guestbook:v1 docker.io/내아이디/guestbook:v1 (4주차)
ghcr.io/회사/앱:2.0 GitHub 의 레지스트리에 있는 이미지

6-2. 태그와 다이제스트

태그 (Tag) 다이제스트 (Digest)
생김새 1.30-alpine sha256:0985e772fb9f...
성격 사람이 붙이는 이름표. 다른 이미지로 옮겨 붙일 수 있음 이미지 내용으로 계산한 지문. 내용이 같으면 항상 같음
비유 "최신판" 이라는 책 제목 책의 ISBN
같은 태그, 다른 내용?

nginx:1.30-alpine 은 보안 패치가 나오면 같은 태그로 새 이미지가 다시 올라옵니다.
운영 환경에서 "절대 바뀌면 안 된다" 면 다이제스트로 고정합니다(nginx@sha256:...). 이 스터디에서는 버전 태그로 충분합니다.

6-3. 멀티 플랫폼 이미지: 태그 하나에 CPU 별 이미지 여러 개

지난주에 Windows 는 x86_64, Apple Silicon Mac 은 aarch64 가 나왔습니다. 그런데 모두 같은 이름 alpine:3.24 를 받았습니다. 어떻게 된 걸까요?

flowchart LR
    T["nginx:1.30-alpine
(이미지 인덱스)"] --> A["linux/amd64 용
→ Windows, Intel Mac"] T --> B["linux/arm64 용
→ Apple Silicon Mac"] T --> C["linux/arm/v7, s390x 등
기타 CPU 용"]

6-4. 레이어: 이미지는 여러 층으로 되어 있다 (맛보기)

docker pull 할 때 여러 줄이 동시에 내려받아지는 것을 보셨나요? 줄 하나하나가 레이어(층) 입니다.

3d85d110b167: Pull complete     ← 레이어 1
22e5a8a110ec: Pull complete     ← 레이어 2
703c5424632f: Pull complete     ← 레이어 3
...

7. 정리 명령어와 주의 사항

명령 하는 일
docker rm <이름> 멈춘 컨테이너 삭제 (실행 중이면 -f)
docker image rm <이미지> 이미지 삭제 (그 이미지를 쓰는 컨테이너가 있으면 거부됨)
docker system df 이미지 / 컨테이너 / 볼륨이 디스크를 얼마나 쓰는지
prune 명령은 조심하세요

docker container prune, docker system prune 은 멈춘 컨테이너, 안 쓰는 이미지 등을 한꺼번에 지웁니다.
다른 업무용 컨테이너가 있는 노트북이라면 필요한 것까지 지워질 수 있습니다.
이 스터디에서는 이름을 지정해서(study-…) 지우는 습관을 들입니다.


핵심 요약

2주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 생명주기   Created → Running ⇄ Paused → Exited → (rm) 삭제
              docker run = create + start (+ 필요하면 pull)
② 끄는 법    stop = SIGTERM → 기다림 → SIGKILL (정중하게)
              kill = 바로 SIGKILL (강제)
              종료 코드 0 = 정상 / 137 = 강제 종료
③ 핵심 규칙   메인 프로세스(PID 1)가 끝나면 컨테이너도 끝난다
④ 로그       앱은 stdout/stderr 로 출력 → docker logs [-f] [--tail N]
⑤ 재시작     --restart unless-stopped : 죽으면 다시 켜되, 사람이 끈 건 존중
⑥ 이미지     docker.io/library/nginx:1.30-alpine
              태그 = 이름표(바뀔 수 있음) / 다이제스트 = 지문(불변)
              태그 하나에 CPU 별 이미지 여러 개 (멀티 플랫폼)

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 1주차 실습 목록으로 2주차 실습 ▶